home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 005 / palert.arc / PALERT.DOC < prev    next >
Encoding:
Text File  |  1986-08-22  |  11.4 KB  |  350 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.                                   P A L E R T
  17.  
  18.                                        by
  19.  
  20.                                  Norm Patriquin
  21.  
  22.  
  23.  
  24.                                    Version 1.0
  25.                                    August 1986
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.                        Copyright 1986 by Norm Patriquin
  34.  
  35.  
  36.  
  37.                         Table of Contents
  38.  
  39.  
  40.       What is PALERT. . . . . . . . . . . . . . . . . . . . . .   1
  41.       Features  . . . . . . . . . . . . . . . . . . . . . . . .   2
  42.       Command Mode Parameters . . . . . . . . . . . . . . . . .   3
  43.       Examples  . . . . . . . . . . . . . . . . . . . . . . . .   5
  44.       Registering PALERT. . . . . . . . . . . . . . . . . . . .   7
  45.       Registration Form . . . . . . . . . . . . . . . . . . . .   8
  46.       Problems and Maintenance. . . . . . . . . . . . . . . . .   9
  47.       Other Utilities . . . . . . . . . . . . . . . . . . . . .   9
  48.                                                                 Page  1
  49.  
  50.       What is PALERT
  51.       --------------
  52.  
  53.       PALERT is a utility program to help you avoid unexpectedly
  54.       running out of disk space.  Many times application programs
  55.       terminate abnormally or disallow you from completing a function
  56.       because of insufficient disk space.  Sometimes, this may
  57.       cause you to lose valuable work time and sometimes causes data
  58.       to be lost. PALERT watches your disk space and warns you when
  59.       space is getting low.
  60.  
  61.       PALERT lets you specify your disk space needs and then watches
  62.       the disk until that limit is reached.  It then warns you of
  63.       the situation and lets you take appropriate action.  PALERT
  64.       is implemented as a standard DOS command that may be used
  65.       by itself or from a DOS batch command file.
  66.  
  67.       Implement PALERT before starting any application or program
  68.       where sufficient disk space is critical.  PALERT will save
  69.       you time and money.
  70.  
  71.                                                                 Page  2
  72.       Features:
  73.       ---------
  74.  
  75.         **  Checks space whenever you want to.
  76.  
  77.         **  Can trigger other commands based on insufficient
  78.             disk space.
  79.  
  80.         **  Many features to customize messages and actions
  81.  
  82.         **  Easy to install and use
  83.  
  84.                                                                 Page  3
  85.  
  86.  
  87.       Command Mode Parameters
  88.       -----------------------
  89.  
  90.       PALERT allows several command parameter switches to be specified
  91.       to customize the process.  All these parameters are optional.
  92.       The command format and switch parameters are described below.  A
  93.       quick review of command parameters is always available by
  94.       entering the PALERT command with the /H parameter.
  95.  
  96.  
  97.       COMMAND FORMAT:
  98.  
  99.       PALERT [drive:]    [ (/ switches) ]
  100.  
  101.  
  102.       [drive:]  If desired you may specify the drive where space
  103.                 is to be checked.  If the drive letter is not
  104.                 specified, the current defualt drive is checked.
  105.  
  106.  
  107.       /Wppp     Warn the user and set DOS ERRORLEVEL flag if the
  108.                 percentage of free disk space is less than the
  109.                 ppp value specified.
  110.  
  111.                 /W5 indicates to warn user if less than 5 percent
  112.                 of disk space is free.
  113.  
  114.  
  115.       /Bbbbb    Warn the user and set DOS ERRORLEVEL flag if the
  116.                 number of kilobytes of free disk space is less than
  117.                 the bbbb value specified.  The maximum value of
  118.                 bbbb is 32767.
  119.  
  120.                 /B3000 indicates to warn the user if less than
  121.                 3,000,000 characters of disk free space exist.
  122.  
  123.  
  124.       /N        A scale that shows used disk space is normally
  125.                 shown to the user each time PALERT is run.  To
  126.                 prevent the scale from being displayed, enter the
  127.                 /N parameter.
  128.  
  129.  
  130.       /M        Messages are normally shown to indicate the Total,
  131.                 Used, and Free disk space.  If these messages are
  132.                 not normally wanted, enter the /M parameter.  Then
  133.                 they will only be issued when the user is warned.
  134.                                                                 Page  4
  135.  
  136.  
  137.       /P        After the user is warned of insufficient disk space,
  138.                 PALERT will pause to make sure the user is aware
  139.                 of the situation.  To avoid this pause enter /P.
  140.  
  141.  
  142.       /S        When PALERT detects insufficient disk space it
  143.                 sounds an alert to the user.  To avoid this noise
  144.                 specify the /S parameter.
  145.  
  146.  
  147.       /C        Each time PALERT is run it reminds the user that
  148.                 HELP is available by entering the /H parameter.  To
  149.                 avoid this message enter /C.
  150.  
  151.  
  152.       /H        PALERT contains internal help that is available at
  153.                 any time by using the /H parameter.
  154.  
  155.                                                                 Page  5
  156.  
  157.  
  158.       Examples:
  159.  
  160.       1.  Warn user when less than 1,000,000 characters of disk
  161.           space is available.
  162.  
  163.               ===> PALERT C: /B1000 /C
  164.  
  165.  
  166.       2.  Warn user when less than 5 percent of disk space is
  167.           available.
  168.  
  169.               ===> PALERT C: /W5 /C
  170.  
  171.  
  172.       3.  DOS batch file that will check disk space each time
  173.           the LOTUS command is entered.  If the desired disk
  174.           space is not available stop the command.
  175.  
  176.             PALERT /b2000/m
  177.             if errorlevel 1 goto error
  178.             LOTUS
  179.             goto end
  180.             :error
  181.             ECHO command terminated due to insufficient disk space
  182.             :end
  183.  
  184.           This sample DOS batch file may be found in the .ARC file
  185.           that contains this program.  Name=PA123.BAT.
  186.  
  187.                                                                 Page  6
  188.  
  189.  
  190.       Registering PALERT
  191.       ------------------
  192.  
  193.       PALERT is distributed under the Shareware concept.  This makes it
  194.       available for anyone to try without obligation.  If you decide it
  195.       is useful and want to keep it, I ask that you register your use
  196.       of it.  This will allow for continued support and maintenance of
  197.       the program and will help to encourage that more quality software
  198.       be made available through this channel.   We require all
  199.       corporate and government users of this utility register their
  200.       copies.
  201.  
  202.       To simply register the program, $10 is requested.  If you would
  203.       like the newest program disk and a copy of the manual send
  204.       $20.  If you would like to register all the Patriquin utilities,
  205.       and receive programs on disk and manuals, send $45.
  206.  
  207.  
  208.       Send registration requests to:
  209.  
  210.                       Norm Patriquin
  211.                       P.O. Box 8308
  212.                       San Bernardino, CA   92412
  213.  
  214.  
  215.       The registration charge is a one time fee that entitles you to
  216.       all future versions of the product.  These may either be obtained
  217.       from normal Shareware sources or directly from me.  Any
  218.       organization ordering more than 100 copies is also entitled to
  219.       telephone support and will be given the technical support number.
  220.  
  221.       Following is a form that may be used to register PALERT.
  222.  
  223.                                                                 Page  7
  224.  
  225.                               PALERT Registration
  226.                                  Version 1.0
  227.  
  228.  
  229.       Please Register PALERT to the following person.  We will use ____
  230.       copies  of  the program and have enclosed $____ for each copy to
  231.       be used.
  232.  
  233.       **************************************************************
  234.  
  235.       _____ Registration only .............................   $10.00
  236.  
  237.       _____ Registration, program disk and manual..........   $20.00
  238.  
  239.       _____ Registration of all Patriquin Utilities with
  240.                program disks and manuals...................   $45.00
  241.  
  242.       _____ Update of newest Patriquin Utility disk with
  243.                manual.  ...................................   $15.00
  244.  
  245.       **************************************************************
  246.  
  247.  
  248.       Name: __________________________________________________
  249.  
  250.       Company: _______________________________________________
  251.  
  252.       Address: _______________________________________________
  253.  
  254.                _______________________________________________
  255.  
  256.       City: ______________________________  State: ___________
  257.  
  258.       Zip:  ______________________
  259.  
  260.       I obtained my copy of PALERT from: ____________________________
  261.  
  262.       If BBS indicate name and number please._________________________
  263.  
  264.       ________________________________________________________________
  265.  
  266.       Please register the software under the following name:
  267.  
  268.       ____________________________________________________
  269.  
  270.               Send to:
  271.                       Norm Patriquin
  272.                       P.O. Box 8308
  273.                       San Bernardino, CA  92412
  274.                                                                 Page  8
  275.                           P A L E R T
  276.  
  277.       Problems and Maintenance
  278.       ------------------------
  279.  
  280.       I welcome all comments or enhancement suggestions. Please
  281.       document each item clearly and provide printed examples if
  282.       possible.  Please be sure to include this form with all requests,
  283.       it will help to make sure we can provide you with the best
  284.       possible service.
  285.  
  286.  
  287.       Name: __________________________________________________________
  288.  
  289.       Company: _______________________________________________________
  290.  
  291.       Address: _______________________________________________________
  292.  
  293.                _______________________________________________________
  294.  
  295.       City: __________________________________  State: _______________
  296.  
  297.       Zip: ______________________________
  298.  
  299.       Telephone: _______ / ________________________ (Home / Work)
  300.  
  301.  
  302.       Date: _________________________
  303.  
  304.       Description of problem or enhancement:
  305.  
  306.       ________________________________________________________________
  307.  
  308.       ________________________________________________________________
  309.  
  310.       ________________________________________________________________
  311.  
  312.       ________________________________________________________________
  313.  
  314.  
  315.       Suggested solution:
  316.  
  317.       ________________________________________________________________
  318.  
  319.       ________________________________________________________________
  320.                                                                 Page  9
  321.  
  322.       Program Maintenance:
  323.       --------------------
  324.  
  325.       Version 1.0     August 22, 1986
  326.  
  327.  
  328.  
  329.       -----------------------------------------------------------------
  330.  
  331.  
  332.  
  333.       Other Patriquin Utilities:
  334.       --------------------------
  335.  
  336.       PSEARCH  --  Extensive file find and Text search capabilities in
  337.                 a menu driven environment.
  338.  
  339.       PCOPY/PMOVE  --  Complete file copy.move utility that prevents
  340.                 users from accidently losing files by using DOS COPY.
  341.                 Fast file movers are intelligent and move files to
  342.                 different hard disk directories without moving data.
  343.  
  344.       PTOUCH  --  Set date and time values on files specified
  345.                 through command parameters.
  346.  
  347.       PALERT  --  Warn users of insufficient disk space before it
  348.                 causes them problems.
  349.  
  350.